home *** CD-ROM | disk | FTP | other *** search
/ Sunday Savers: Singing Fun! / Sunday Savers: Singing Fun!.iso / mac / Xtras / Buddy API 1.6 / Buddy API Docs.swf / texts / 1104.txt < prev    next >
Encoding:
Text File  |  2004-08-31  |  3.2 KB  |  133 lines

  1. 17
  2. --- RECORDSEPARATOR ---
  3.  
  4. --- RECORDSEPARATOR ---
  5. WriteIni 
  6. --- RECORDSEPARATOR ---
  7. Platform:
  8. --- RECORDSEPARATOR ---
  9.  
  10. --- RECORDSEPARATOR ---
  11. Windows and Macintosh.
  12. --- RECORDSEPARATOR ---
  13.  
  14. --- RECORDSEPARATOR ---
  15. Description:
  16. --- RECORDSEPARATOR ---
  17.  
  18. --- RECORDSEPARATOR ---
  19. baWriteIni writes a string into a Windows style ini file.
  20. --- RECORDSEPARATOR ---
  21.  
  22. --- RECORDSEPARATOR ---
  23. Usage:
  24. --- RECORDSEPARATOR ---
  25.  
  26. --- RECORDSEPARATOR ---
  27. Result = baWriteIni( Section, Keyname, NewValue, IniFile )
  28. --- RECORDSEPARATOR ---
  29.  
  30. --- RECORDSEPARATOR ---
  31. Arguments:
  32. --- RECORDSEPARATOR ---
  33.  
  34. --- RECORDSEPARATOR ---
  35. String, String, String, String. 
  36. --- RECORDSEPARATOR ---
  37. Section is the section name of the ini file. 
  38. --- RECORDSEPARATOR ---
  39. Keyname is the name of the key 
  40. --- RECORDSEPARATOR ---
  41. NewValue is the string to write into the file. 
  42. --- RECORDSEPARATOR ---
  43. IniFile is the name if the ini file to use.
  44. --- RECORDSEPARATOR ---
  45.  
  46. --- RECORDSEPARATOR ---
  47. Returns:
  48. --- RECORDSEPARATOR ---
  49.  
  50. --- RECORDSEPARATOR ---
  51. Integer. 
  52. --- RECORDSEPARATOR ---
  53. Returns 1 if the function was successful, else 0.
  54. --- RECORDSEPARATOR ---
  55.  
  56. --- RECORDSEPARATOR ---
  57. Examples:
  58. --- RECORDSEPARATOR ---
  59.  
  60. --- RECORDSEPARATOR ---
  61. Director: 
  62. --- RECORDSEPARATOR ---
  63. set OK = baWriteIni( "CurrentUser", "UserName", "Gary Smith", "Userdat.ini" ) 
  64. --- RECORDSEPARATOR ---
  65. Authorware: 
  66. --- RECORDSEPARATOR ---
  67. OK := baWriteIni( "CurrentUser", "UserName", "Gary Smith", "Userdat.ini" )
  68. --- RECORDSEPARATOR ---
  69.  
  70. --- RECORDSEPARATOR ---
  71. Notes:
  72. --- RECORDSEPARATOR ---
  73.  
  74. --- RECORDSEPARATOR ---
  75. An entry in a Windows ini file has the following format : 
  76. --- RECORDSEPARATOR ---
  77. [Section] 
  78. --- RECORDSEPARATOR ---
  79. Keyname=string 
  80. --- RECORDSEPARATOR ---
  81. This function will write the string after the equals sign. When using this function, 
  82. --- RECORDSEPARATOR ---
  83. the Section name you use should not include the square brackets around the 
  84. --- RECORDSEPARATOR ---
  85. name. The Keyname should not include the equals sign. For example the ini file for 
  86. --- RECORDSEPARATOR ---
  87. the example above might look something like this 
  88. --- RECORDSEPARATOR ---
  89. [CurrentUser] 
  90. --- RECORDSEPARATOR ---
  91. UserName=Gary Smith 
  92. --- RECORDSEPARATOR ---
  93. Password=mypw 
  94. --- RECORDSEPARATOR ---
  95. ModulesCompleted=4 
  96. --- RECORDSEPARATOR ---
  97. The IniFile can be in any directory. On
  98. --- RECORDSEPARATOR ---
  99.  Windows
  100. --- RECORDSEPARATOR ---
  101.  if the full path name is not 
  102. --- RECORDSEPARATOR ---
  103. specified, the file will be created in the Windows directory, on the
  104. --- RECORDSEPARATOR ---
  105.  Macintosh
  106. --- RECORDSEPARATOR ---
  107.  it will 
  108. --- RECORDSEPARATOR ---
  109. be created  in the Preferences folder. 
  110. --- RECORDSEPARATOR ---
  111. The ini file does not have to have an .ini extension: any extension can be used. If 
  112. --- RECORDSEPARATOR ---
  113. the ini file does not exist, then it will be created. 
  114. --- RECORDSEPARATOR ---
  115. This function will write a maximum of 
  116. --- RECORDSEPARATOR ---
  117. 32000 characters. 
  118. --- RECORDSEPARATOR ---
  119. On Win95, strings written to an ini file can not contain a tab character.
  120. --- RECORDSEPARATOR ---
  121.  
  122. --- RECORDSEPARATOR ---
  123. See also:
  124. --- RECORDSEPARATOR ---
  125.  
  126. --- RECORDSEPARATOR ---
  127. baReadIni 
  128. --- RECORDSEPARATOR ---
  129. baFlushIni 
  130. --- RECORDSEPARATOR ---
  131. baDeleteIniEntry 
  132. --- RECORDSEPARATOR ---
  133. baDeleteIniSection